home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / fax_sstv / ezsstv / config.txt < prev    next >
Text File  |  1996-06-18  |  12KB  |  419 lines
  1.                 Configuration File
  2.                 ------------------
  3.  
  4. Many characteristics of Pasokon TV operation are controlled
  5. by the contents of a file called PKTV.CFG (or EZSSTV.CFG).  
  6. Many people will never have to look at this file because the 
  7. most commonly changed characteristics - such as printer type 
  8. and interrupt for the SSTV interface - can be set from the 
  9. graphical user interface.
  10.         
  11. To change the more obscure options, edit PKTV.CFG (or EZSSTV.CFG)
  12. with your favorite text editor.
  13.  
  14. General rules:
  15.  
  16. 1. Blank lines and comment lines, beginning with "*", are
  17.    ignored.  When removing an option you just might want to
  18.    put an "*" in front of it instead of deleting the line in
  19.    case you might want to put it back in someday.
  20.    
  21. 2. Commands can be in either upper or lower case.  Keywords
  22.    are shown in upper case in the examples so they stand out
  23.    more.  Variable parts are shown in lower case.
  24.    Optional parts are shown in { }.
  25.  
  26. 3. There is no way to split a command across multiple lines.
  27.    Some of the examples show long commands on more than one line
  28.    but you must enter the entire command on a single line.
  29.  
  30.  
  31. Most commands are the same for both Pasokon TV Classic and
  32. EZ SSTV.  The few differences are noted.
  33.  
  34. In alphabetical order:
  35.  
  36.  
  37. AD_AFTER n
  38. --------
  39.  
  40. Not used in this version.
  41.  
  42.  
  43. AUTO_SAVE_DIR path      (not available in EZ SSTV)
  44. -------------
  45.  
  46. Directory used by the functions in the Auto Save control panel.
  47. The INSTALL program creates the line:
  48.  
  49.         AUTO_SAVE_DIR C:\AUTOSAVE
  50.  
  51. which should be fine for most people.  This directory is 
  52. created automatically when needed.
  53.  
  54.  
  55. AUTO_XMIT n
  56. ---------
  57.  
  58. This means gather and transmit an image once every n seconds.
  59. This was added for a remote surveillance applications but it
  60. could have many other uses.  Perhaps an FSTV to SSTV gateway???
  61.  
  62. For example, if n was 120, the system would automatically
  63. repeat this sequence every two minutes:
  64.  
  65.         * Perform the actions in the DIGITIZE command
  66.           (see description below).
  67.         * Transmit the image.
  68.  
  69. Usually, the DIGITIZE command is used to grab an image from 
  70. a framegrabber but it could be used to run any other external
  71. program which produces an image.
  72.  
  73. See also: COM_PORT.
  74.  
  75.  
  76. CALL call
  77. ----
  78.  
  79. Generated automatically with your amateur radio call sign 
  80. entered during installation.
  81.  
  82.  
  83. CHECKSUM n
  84. --------
  85.  
  86. Created by INSTALL program.  Don't change or remove it.
  87.  
  88.  
  89. COM_PORT n [ addr irq ]         ( EZ SSTV Only )
  90. --------
  91.  
  92. Any of the serial ports, COM1 through COM4 may be specified
  93. but there is a restriction for machines with more than two
  94. serial ports or an internal modem.  The serial port for the
  95. SSTV interface can not share an interrupt with another device.
  96.  
  97. For example, if you had a serial mouse on COM1, you could
  98. not use COM3 for the SSTV interface if it uses the same
  99. interrupt.
  100.  
  101. The standard serial port I/O addresses and interrupts
  102. are listed below:
  103.  
  104.                         Standard        Standard
  105.         Serial Port     I/O Address     Interrupt (IRQ)
  106.         -----------     -----------     ---------------
  107.            COM1            3F8             4
  108.            COM2            2F8             3
  109.            COM3            3E8             4
  110.            COM4            2E8             3
  111.  
  112. In most cases, you can use the short form of the COM_PORT
  113. command with just the serial port number.  Example:
  114.  
  115.         COM_PORT 2
  116.  
  117. In this case, the standard I/O address and IRQ, from the table
  118. above, will be used.  
  119.  
  120. COM3 and COM4 ports will generally use the standard I/O address
  121. as shown above, but the IRQ will often be changed to avoid a
  122. conflict with COM1 or COM2.  In this case, the longer form must
  123. be used.  For example:
  124.  
  125.         COM_PORT 3 3E8 10
  126.  
  127. Further discussion can be found in IOADDR.TXT and IRQ.TXT.
  128.  
  129.  
  130. COM_PORT n              ( Pasokon TV Classic )
  131. --------
  132.  
  133. This is used only in conjunction with the AUTO_XMIT command.
  134. When this is specified, the automatic transmission sequence 
  135. can be paused by activating the DCD line of the specified 
  136. COM port.
  137.  
  138.  
  139. DIGITIZE
  140. --------
  141.  
  142. This contains a sequence of actions to perform for the 
  143. Digitize item in the File menu or the Camera icon in the
  144. paint tool box.  It is also used with the AUTO_XMIT 
  145. command.
  146.  
  147. Normally this is used to grab an image from a framegrabber
  148. with 3 actions:
  149.  
  150.         1. Run an external program which captures a video
  151.            signal and stores it into a temporary file.
  152.         2. Read that image file.
  153.         3. Delete the temporary image file.
  154.  
  155. This is essentially the same as the RUN_MENU items except
  156. it uses fixed item in the File menu rather than a user
  157. defined item in the Run menu.
  158.  
  159. Read RUN.TXT for an in depth description.
  160.  
  161.  
  162. EXPERIMENT
  163. ----------
  164.  
  165. Used for various experiments by the author.  No telling what 
  166. will happen if you use this.
  167.  
  168.  
  169. FAST_16M
  170. --------
  171.  
  172. There are a couple different ways to display 16 million color
  173. images on the screen.  Normally, the slower, standard method
  174. is used.  With some models of VGA displays, but not all, it is
  175. possible to use another faster method by specifying this option.
  176. See VGAINFO.TXT for more details.
  177.  
  178.  
  179. FREE_RUN n
  180. --------
  181.  
  182. This corresponds to the "Free Run" item in the Setup menu.
  183. Normally you'd use the menu and not have to manually edit this.
  184.  
  185.  
  186. GMODE mode
  187. -----
  188.  
  189. Force a particular graphics display mode instead of using
  190. automatic detection of the best one available.
  191. See VGAINFO.TXT for more detailed description.
  192.  
  193.  
  194. HEADER_MESSAGE "message"
  195. --------------
  196.  
  197. Many of the SSTV transmission modes use an 8 or 16 line gray
  198. scale header at the top of the image.  You can specify a
  199. message up to 25 characters to be used for the modes which
  200. have a 16 line header.  The quotation marks (") are important.
  201.  
  202. Example:
  203.         HEADER_MESSAGE "John - Chelmsford, MA"
  204.  
  205.  
  206. IMAGES n
  207. ------
  208.  
  209. This specifies the number of thumbnail images along the 
  210. bottom of the screen.  If you don't have much memory you
  211. might want to use a smaller value to reduce the amount of
  212. image swapping in and out of memory.
  213.  
  214. The default is 5 (good for a machine with 8 megabytes) and 
  215. the maximum is 10.  Normally you'd set this from the Setup menu.
  216.  
  217.  
  218. INIT_DIR path
  219. --------
  220.  
  221. This is the initial directory for the file selector.
  222.  
  223. Suppose you kept your favorite images in a directory called 
  224. IMAGES, you could add this item to the configuration file:
  225.  
  226.         INIT_DIR C:\IMAGES
  227.  
  228. The first time you used the file selector, it would be 
  229. set to c:\images instead of the directory where the 
  230. software is installed (typically c:\pktv3).
  231.  
  232.  
  233. IO_ADDR n               ( Pasokon TV Classic Only )
  234. -------
  235.  
  236. The Input/Output base address for the Pasokon TV Classic
  237. interface.  This can be set from the graphical user interface 
  238. so setting this manually will be rare.
  239.  
  240. More details are in IOADDR.TXT.
  241.  
  242.  
  243. IRQ n                   ( Pasokon TV Classic Only )
  244. ---
  245.  
  246. This is the interrupt number used by the Pasokon TV Classic
  247. interface.  This can be set from the Setup menu.
  248.  
  249. A detailed explanation can be found on the Help menu or in 
  250. the file IRQ.TXT.
  251.  
  252.  
  253. JPEG_QUALITY n          (JPEG not in EZ SSTV)
  254. ------------
  255.  
  256. JPEG allows you to specify a trade-off between file size
  257. and image quality.  This corresponds to one of the options
  258. in the File menu.
  259.  
  260.  
  261. NAME "name"
  262. ----
  263.  
  264. This is filled in by the INSTALL program.
  265.  
  266.  
  267. NO_IRQ_WARN             ( Pasokon TV Classic Only )
  268. -----------
  269.  
  270. Pasokon TV tries - not always successfully - to determine
  271. whether the specified IRQ level is in use by another device.
  272. There was one reported case where Pasokon TV complained about
  273. a conflict on every IRQ level even though there was not a
  274. conflict.  This command suppresses the warning message.
  275.  
  276.  
  277. NO_PAUSE_CLOCK
  278. --------------
  279.  
  280. Pasokon TV stops the software time-of-day clock while 
  281. transmitting and receiving because the timer interrupts can 
  282. disrupt the SSTV timing.  This does not affect the hardware 
  283. clock.  The time will be correct when the machine is rebooted.
  284.  
  285. Add the "NO_PAUSE_CLOCK" option to the PKTV.CFG file and the 
  286. clock will not be affected.  This is fine in most cases but 
  287. there is a chance that it will interfere with the SSTV timing.
  288.  
  289. Using this would definitely mess up EZ SSTV operation.
  290.  
  291.  
  292. NO_12C_VIS
  293. ----------
  294.  
  295. The VIS code for Robot 12 second color is all zeros.
  296. Sometimes a steady carrier will be misinterpreted as the
  297. beginning of a 12 second color picture.
  298. Detection of this one code can be disabled with the 
  299. NO_12C_VIS option.   You can still receive this mode
  300. by selecting it manually.
  301.  
  302.  
  303. OPEN file
  304. ----
  305.  
  306. When Pasokon TV starts up, it will read this file into memory.
  307. Example:
  308.         OPEN MUGSHOT.TIF
  309.  
  310.  
  311. PRINTER_GAMMA n
  312. -------------
  313.  
  314. This controls the mapping of image brightness to dot density
  315. on the printer.  This is normally set from the Setup menu.
  316.  
  317.  
  318. PRINTER_PORT n
  319. ------------
  320.  
  321. Printer port number.  Normally set from the Setup menu.
  322.  
  323.  
  324. PRINTER_TYPE n
  325. ------------
  326.  
  327. n is an internal code for one of the supported printer types.
  328. Pick a printer description from the Setup menu instead of 
  329. editing this line manually.
  330.  
  331.  
  332. RECV_IDLE n
  333. ---------
  334.  
  335. The system will automatically start Receive mode after n
  336. seconds of user inactivity.  This would be handy for public
  337. systems at museums, club stations, etc.  Just put "TV" at
  338. the end of the AUTOEXEC.BAT file and Pasokon TV will start
  339. automatically when the system is started up.  If no one
  340. uses the keyboard or mouse for the specified amount of time,
  341. the system will automatically go into receive mode.
  342.  
  343.  
  344. RECV_UNDO
  345. ---------
  346.  
  347. When you click on the "Recv" button or press Enter to start
  348. receive mode, the current image is not normally saved before
  349. being cleared.  In other words, you can't use the Undo menu 
  350. item or the Escape key to get it back.
  351.  
  352. Adding the RECV_UNDO command will cause the current image
  353. to be saved when the receive mode is started so you can use
  354. the Undo function.  This takes time and may cause excessive 
  355. disk activity on systems without a lot of memory.  
  356.  
  357.  
  358. RUN_MENU .......
  359. --------
  360.  
  361. Pasokon TV has a "Run" menu with user-defined commands that
  362. can read/write image files and run external programs.
  363. This is a very involved topic which has its on description
  364. in the RUN.TXT file.
  365.  
  366.  
  367. SAVE_HALF_SIZE          (not available in EZ SSTV)
  368. --------------
  369.  
  370. This corresponds to the "320 x 240" option in the File menu.
  371. Normally you would not manually edit this. 
  372.  
  373.  
  374. SERIAL_NUM              ( Pasokon TV Classic Only )
  375. ----------
  376.  
  377. Interface serial number.  
  378.  
  379.  
  380. SLOW_CPU
  381. --------
  382.  
  383. This reduces the image sampling rate for the S1, S3, M1, and
  384. M3 modes which are the most demanding.  Image detail will
  385. suffer a little so this is a last resort.  Read TOOSLOW.TXT
  386. for more information.
  387.  
  388.  
  389. SSTV_MODE n
  390. ---------
  391.  
  392. This is the initial SSTV mode selected when the program starts
  393. up.  The number, n, is an undocumented internal code that may
  394. vary between versions so this would not normally be added by
  395. manual editing.
  396.  
  397. Follow these steps to set the default start up mode:
  398. 1. Run PKTV.
  399. 2. Select the desired mode.
  400. 3. Pick "SSTV Mode" from the "Setup" menu.
  401. 4. Pick the button marked "Default".
  402.  
  403.  
  404. SYNC_SQUELCH
  405. ------------
  406.  
  407. This corresponds to the Sync Squelch item in the Setup menu.
  408.  
  409.  
  410. TGA_32K n               (TGA not available in EZ SSTV)
  411. -------
  412.  
  413. When n is 0, .TGA files are saved in 16M colors.
  414. When n is 1, .TGA files are saved in 32k colors.
  415. This makes files about 2/3 the size.
  416.  
  417. Default if command missing: 16M colors.
  418. Normally you'd change this from the File menu.
  419.